home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / vbbs61a2.zip / VBBSDOOR.DOC < prev    next >
Text File  |  1993-05-30  |  32KB  |  889 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.            ██┐    ██┐ ████████┐ ████████┐ ███████┐
  7.            ██│    ██│ └██┌──██│ └██┌──██│ ██┌────┘
  8.             ██┐  ██┌┘  ███████│  ███████│ ███████┐
  9.              ██┐██┌┘   ██┌──██│  ██┌──██│ └────██│
  10.               ███┌┘   ████████│ ████████│ ███████│
  11.               └──┘    └───────┘ └───────┘ └──────┘
  12.                       *
  13.  
  14.                  The Virtual BBS/NET
  15.                 Version 6.10
  16.  
  17.           (C) Roland De Graaf 1990, 1991, 1992, 1993
  18.  
  19.                   4246 Elisabeth Ave.
  20.                   Holland, MI 49424
  21.  
  22.                       *
  23.      ╔════════════════════════════════════════════════════════════════╗
  24.      ║                 VBBS Doors Documentation                       ║
  25.      ╠════════════════════════════════════════════════════════════════╣
  26.      ║ Written By: Kevin Klunk, aka Lord Doomslayer 2@5081 VirtualNET ║
  27.      ║  Edited By: Thom Harris, aka Da'Chief        1@6171 VirtualNET ║
  28.      ║  Format By: Sam Fleming, aka O. F.           1@2056 VirtualNET ║
  29.      ╚════════════════════════════════════════════════════════════════╝
  30.  
  31.                 TABLE OF CONTENTS                             
  32.  
  33.            (1) General Information
  34.             1.1 - Dropfiles
  35.             1.2 - FOSSIL Drivers
  36.  
  37.            (2) Preparation, Installation, and Execution
  38.             2.1 - Game Files
  39.             2.2 - Batch Files
  40.               2.21 - Game Batch Files
  41.               2.22 - Maintenance Batch Files
  42.             2.3 - Interfacing with the BBS
  43.               2.31 - VBBS Door Configuration Menu
  44.               2.32 - Script Installation
  45.               2.33 - Function Block Installation
  46.  
  47.            (3) Programs and Utilities
  48.             3.1 - DoorWay
  49.             3.2 - DoorMaster
  50.             3.3 - VReturn/WWIVDoor
  51.             3.4 - Virtual ToolKit
  52.  
  53.            (4) Miscellaneous Information
  54.             4.1 - Enhancements
  55.             4.2 - Copyright Information & Distribution Sites
  56.             4.3 - Final Comments
  57.  
  58.     NOTE: The words DOOR and GAME are used interchangeably throughout this
  59.       document.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                        VBBS Doors Documentation --  2
  70.  
  71.  
  72.      ╔════════════════════════════════════════════════════════════════╗
  73.      ║ (1) GENERAL INFORMATION                                        ║
  74.      ╚════════════════════════════════════════════════════════════════╝
  75.    
  76.      1.1 - Dropfiles
  77.      ═══════════════
  78.  
  79.         Dropfiles (DF) are the link between the BBS and the game 
  80.      itself.  A DF contains all of the required info for the game to 
  81.      operate properly.  This includes the user's "handle" (so he al-
  82.      ways uses the same slot in the game), the user's COM port & speed
  83.      (so the game knows where to send the data), and other miscellan-
  84.      eous info - the BBS name, sysop name, user's time remaining (on 
  85.      the BBS), etc.
  86.  
  87.      Here is a list of many of the common dropfile formats:
  88.  
  89.         Types          Original BBS format     VBBS Supported?
  90.        -----------------  ----------------------   ---------------
  91.          CALLINFO.BBS     Wildcat! 2.x                  No
  92.         CHAIN.TXT     WWIV                          Yes
  93.          DOOR.SYS     Wildcat! 3.x & Others         Yes
  94.          DORINFOx.DEF     QBBS / RBBS                   Yes
  95.           PCBOARD.SYS     PC Board                      No
  96.           SFDOORS.DAT     Spitfire                      No
  97.  
  98.         At the present time VBBS supports the CHAIN.TXT, 
  99.      DORINFOx.DEF and DOOR.SYS dropfiles.  They are fairly simple to 
  100.      use; the only one needing an extended explanation is the 
  101.      DORINFOx.DEF.  All the dropfiles are created in your \VBBS di-
  102.      rectory.
  103.  
  104.      The 'x' in DORINFOx.DEF is the node number that the user is 
  105.      logged in on.  On a single-line system this will always be a '1',
  106.      the normal local node would be a '0', and node 2 would be a '2'.
  107.      Many of the newer games that are coming out allow for multiple 
  108.      players in the game at the same time, and some even allow inter-
  109.      action between the players.  Almost all of these games require 
  110.      the DORINFOx.DEF dropfile.
  111.  
  112.      The DOOR.SYS dropfile is a fairly generic dropfile accessible to
  113.      many games and is VERY common.   It requires no special work to 
  114.      use with a game.  The CHAIN.TXT dropfile is used predominantly by 
  115.      WWIV-based doors, and most can be used with VBBS (see section 3.3 
  116.      for more information.)
  117.  
  118.  
  119.      1.2 - FOSSIL Drivers
  120.      ════════════════════
  121.  
  122.         FOSSIL drivers are external TSR's that handle carrier de-
  123.      tection routines for programs that cannot do it themselves.  You
  124.      do not HAVE to use a FOSSIL driver for all games, so you do not
  125.      have to load one at start-up (unless your modem configuration 
  126.      requires one.)  Sometimes they are required if you are using a 
  127.      high-speed modem, but this DOES vary.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                        VBBS Doors Documentation --  3
  136.  
  137.  
  138.      The two most commonly used FOSSIL drivers are BNU and X00.  Both 
  139.      allow installation before running a door and removal afterwards. 
  140.      See section 4.2 for information or where you can get these pro-
  141.      grams. You will want to go through the documentation files on the 
  142.      FOSSIL driver for specific installation information, as the setup
  143.      varies widely based on the hardware used.
  144.  
  145.      ╔════════════════════════════════════════════════════════════════╗
  146.      ║ (2) Preparation, Installation, and Execution                   ║
  147.      ╚════════════════════════════════════════════════════════════════╝
  148.  
  149.      2.1 - Game Files
  150.      ════════════════
  151.  
  152.         Installing the game onto your system is the first step to-
  153.      wards getting it to work.  The first thing you should do when you 
  154.      get a new game is unZIP/deARJ/unPAK/whatever the compressed file
  155.      is into its own directory.  Then load up your favorite text edi-
  156.      tor/viewer and read the sysop documentation.  Almost all ques-
  157.      tions can be answered with the docs included with the games.
  158.      While you are reading, take note of the following information:
  159.  
  160.      Installation - does this program self-install?
  161.               - does this program need to be in a special
  162.                directory to run?
  163.               - does this program have a configuration file
  164.                that needs to be made / altered?
  165.               - how do you initialize the game files?
  166.      Dropfiles    - does it use one of the 3 supported by VBBS
  167.                 or does it require a special dropfile?
  168.      FOSSIL Driver- Is one needed for this program to run?
  169.      Command Line - Quite often there are MANY switches that
  170.                can be used on the command line. Make SURE
  171.                that you note ALL the possible switches.
  172.               - Major switches to look for are:
  173.                 Dropfile Type              Dropfile Path
  174.                 FOSSIL (Y/N)               Node Number Info.
  175.                 Configuration Filename     Local Play Mode
  176.  
  177.         Before you continue, make sure the game will support one 
  178.      of the three dropfiles that VBBS supports (either DOOR.SYS, 
  179.      DORINFOx.DEF, or CHAIN.TXT.)  If it does not then there are two 
  180.      other ways you can get the game to run with your BBS.
  181.  
  182.      1> Get a Door Converter program - these programs allow you to
  183.         take a dropfile that you already have (ie DOOR.SYS) and run 
  184.         it through the converter to produce a different dropfile for-
  185.         mat (see section 3.2 for more detailed information).
  186.  
  187.      2> Some games allow you to create your own dropfile for use with
  188.         the game.  If it is possible to do so then all you need to do
  189.         is write down the information that has to appear in the file
  190.         and the order it must appear.  You can then either write up a
  191.         script or a batch file to create the new dropfile for the game.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                        VBBS Doors Documentation --  4
  202.  
  203.  
  204.      If neither of these options are available then place the game on
  205.      a floppy for storage and check to see if any local (or network)
  206.      sysops can give you a hand. The most important rule when setting
  207.      up a game is 'Ask Lots Of Questions.'  If you cannot find the an-
  208.      swers in the docs, then you NEED to ask someone else. Do not give
  209.      up on the game if it does not seem to work when it is first in-
  210.      stalled, many games require a bit of fine-tuning to match your 
  211.      specific system setup.
  212.  
  213.         At this point run any installation program (if supplied) 
  214.      and fill in the required information.  Remember to write down any
  215.      information that the program gives you during the installation.
  216.  
  217.      Most doors require you to modify a configuration file.  You can 
  218.      do this with your favorite text editor and make a